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INTRODUCTION 



ASMBLE is a Z-80 source code macro assembler which produces 
either an absolute binary, a hex, or a relocatable code module 
and a prograira listing. The assembler allows you to specify the 
devices and file names for the input and output files as well as 
which output files you want generated. If you ask for a listing, 
it will contain a column alphabetized symbol table. 



FEATURES 



1) Two pass operation 

2) Conditional assembly 

3)' 'External labels and relocatable code 

4) Absolute binary or hex code 

5) Separation of code and data spaces 
$) Macros 

n ) Include files . 

*$) Column alphabetized symbol table in listing 
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WHO SHOULD USE THIS MANUAL? 

You may be reading this manual because you want to know how to 
assemble, link, and run a program written in Pascal. If this is 
the case, you should skip this manual and read the first part of 
the linker manual since the Pascal compiler takes care of 
generating all the assembler code that is normally required to 
run a Pascal program. 

On the other hand , you may want to add your own assembler 
routines to a Pascal program, or you may want to write a 
stand-alone assembler program. In that case, you should 'read 
this entire manual and then read the linker manual. 
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ASSEMBLING 



Here are the steps you go through from the creation of an 
assembly language program to its execution. 

1) Run the text editor, create a new SRC file on a disk f 
and type in your program (written in assembler 
mnemonics) . 

2) Run the assembler which translates the assembler 
mnemonic statements into machine language code. 

1) If you asked the assembler to generate a 'relocatable 
module, you run the linker which loads the module into 
memory, and start the program. 

If you asked the assembler to generate hex code, you 
run the loader which translates .the hex code into a 
•COM file. You then run the COM file. 

If you asked the assembler to generate a COM file, yon 
run it. 



In your program you tell the machine exactly what to do b-c 
writing. a list of mnemonic machine instructions. These mnemonic? 
are translated, one to one, into machine. executable instructions 
(machine code> . 



Each machine instruction has its corresponding mnemonic. For 
example, if you want to move a copy of the byte from the B 
register into the A register you write: 

MOV A , B 

If you want to complement the byte in the A register you write: 

CMA 
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An instruction is one or more bytes long and is stored in one or 
more consecutive memory locations. You can symbolically 
reference an instruction by placing a .label in front of the 
instruction and referencing the label. For example, suppose you 
want to write a routine that decides whether or not a value in 
the A register is equal to ten. You might write: 



CPI 


10 


► Does A = 10? 


JZ 


TARGET j 


Yes. 


XRA 


A 


• No. Make it 


TARGET: MOV 


B r A 


• Save it in B. 



In this example, if the A register contains ten , the machine 
jumps to the instruction bearing the" TARGET label. You' can 
locate this routine anywhere in memory and not worry about the 
location which TARGET represents (the value of TARGETS . The 
assembler calculates it for you. 



You may also give 

instruction . 



value to a symbol with an equate 



ENDVAL EQU 



10 



Here, ENDVAL is given the absolute value ten. It has this value 
no matter where it is defined. You may use it in your program as 
follows : 



ENDVAL. EQU 


10 




CPI 


ENDVAL ; 


Does A = ENDVAL? 


JZ 


TARGET ; 


Yes. 


XRA 


A 


• No. Make it 0. 


TARGET :MOV 


B,A 


* Save it in B. 



ASMBLE/Z 



- 4 - 



A section of an assembly code may be switched on or off by 
surrounding the code with conditional statements. For example: 

FALSE EQU 

TRUE EQU NOT FALSE 

ORANGE EQU TRUE 

IF ORANGE 

NAME: DB 'This program is called Orange 1 

ELSE 

NAME: DB 'This program is called Lemon' 

ENDIF 

In this example, the first three statements define the values of 
the symbols FALSE, TRUE, and ORANGE. The conditional statements, 
IF, ELSE, and ENDIF, select one of the two statements labeled 
NAME for assembly. 

Code which is often repeated, possibly with some variation, may 
be stored in a macro and assembled simply by giving the name of 
the macro. This saves a little typing and usually makes the 
program easier to understand. For example: 



PRINT: MACRO 


TEXT 


LXI 


H,TEXT 


CALL 


TEXT 


EN DM AC 




• 

PRINT 

• 


HITEXT . 


• 

HITEXT:DB 


'Hi there' 



In this example, the first four lines define the macro called 
PRINT which contains, one dummy parameter, TEXT. When the 
statement PRINT HITEXT is assembled it is replaced by: 

LXI H, HITEXT 
CALL TXTYP 

This loads the address of the text string into the HL register 
and calls TXTYP to print the string. 
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Here is a- short example of a program that reads the front panel 
switches and sets the -front panel lights' accordingly. It 
contains a conditional control switch, FLIP, which causes the 
assembler to generate code to complement the value sent to the 
lights if FLIP is true. If all the switches are up the program 
returns control to the monitor. 

; Light Test. 



FALSE 
TRUE 

FLIP 



EQU 
EQU 

EQU 



NOT FALSE 

TRUE ; Complement flag. 



LIGHTS EQU OFFH 
SWITCH EQU OFFH 



; Front panel lights port. 
; Front panel switch port. 



ENDCOD EQU 



111111118; Switch pattern for stop. 



NDTEST 


: MACRO 

CPI 

JZ 

ENDMAC 


ENDCOD 





ORG 


100H 


LOOP: 


IN 
NDTEST 


SWITCH 




IF 

CMA 

ENDIF 


FLIP 




OUT 
JR 


LIGHTS 
LOOP 



Xest for ENDCOD in A. 

Time to quit? 

Yes. Back to monitorland. 



Put the code at location 100H. 

Read the switches. 
Test for end. 



Flip the bits. 



Display in the lights. 
And repeat. 



END 



LOOP 



Start at LOOP. 
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Here is a listing of 
"assembled. Notice 
'rea.ted . 

Light Test. 



0000 

FFFF 

FFFF 

0OFF 
00FF 

OOFF 

0000 



the program in the previous example as" it is 
how the macro and conditional code is 



0100 

0100 DB FF 

0102+FE FF 
010'4+CA 0000 

FFFF 
0107 2P 



0108 D3 FF 
010A 18 F4 



; Light Test. 

FALSE. EQU 
TRUE EQU 



FLIP 



EQU 



0100 



LIGHTS EQU 
SWITCH EQU 

ENDCOD EQU 

NDTEST: MACRO 
CPI 
JZ 

ENDMAC 

ORG 

LOOP: IN 

NDTEST 
CPI 
JZ 

IF 

CMA 

ENDIF 

OUT . 

JR 

END 
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NOT FALSE 

TRUE ; Complement flag. 

OFFH ; Front panel lights port. 
OFFH ; Front panel switch port. 

11111111B; Switch pattern for stop. 

; Test for ENDCOD in A. 
ENDCOD ; Time to quit? 
; Yes. Back to monitorland. 



100H 



; Put the code at location 100 1 -* 



SWITCH ; Read the switches. 
; Test for end. 
ENDCOD ; Time to quit? 
;Yes. Back to monitorlanc 



FLIP 



LIGHTS 
LOOP 

LOOP 



; Flip the bits. 



; Display in the lights 
; And repeat. 

; Start at LOOP. 
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Here is a listing of the same; program except that FLIP has.-', been 
set to false. Notice how this changes the conditional code. 



Light Test. 



0000 

FFFF 

0000 

00FF 
00FF 

00FF 

0000 



0100 

0100 DB FF 

0102+FE FF 
0104+CA 0000 

0000 



0107 D3 FF 
0109 IB F5 

0100 



; Light Test. 

FALSE EQU 
TRUE EQU 



FLIP 



EQU 



LIGHTS 

SWITCH 


EQU 
EQU 


OFFH 
OFFH 


ENDCOD 


EQU 


linn. 


NDTEST: 


: MACRO 
CPI 
JZ 
ENDMAC 


END( 





ORG 


1 00H 


LOOP: 


IN 

NDTEST 
CPI 
JZ 


SWITCH 

END' 





IF 

CMA 

ENDIF 


FLIP 




OUT 
JR 


LIGHTS 
LOOP 



END 
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NOT FALSE 

FALSE ; Complement flag. 

; Front panel lights port. 
; Front panel switch port. 

1111111VB; Switch pattern for stop. 

; Test for ENDCOD in A. 
D ; Time to quit? 

: Yes. Back to monitorland. 



; Put the code at location 100H 

; Read the switches. 

; Test for end . 

D ; Time to quit? 

; Yes. Back to monitorl,' ^ . 

; Flip the bits. 



; Display in the lights. 
; And repeat. 

; Start at LOOP. 



LOOP 
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ASSEMBLER OPERATION 



The assembler operates in two passes. Its operation is almost 
identical in both passes. 

During the first pass the input file is read and each source line 
is processed. Each time a symbol is defined it is entered intc 
the symbol table. All error messages except SYMBOL NOT FOUND, 
REDEFINED, and OUT OF RANGE are printed during pass one. 

During pass two the input file is read again and each source line 
is processed. If the source line generates any machine code, it 
is sent to either the binary, hex, or relocatable output file in 
the proper format. A copy of the line of source text along with 
the address and generated machine code is sent to the listing 
file. 



ONCE THRU CODE 

The initialization routine used by the assembler' is written in 
once through code and is located in the symbol table region. You 
may restart or save the assembler at any time while the assembler 
is asking the file name, question. After the question has beer 
answered, the assembler no longer needs the initialization code 
and destroys it. From this point on the assembler must be 
reloaded in order to restart it. 
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RELOCATION 



There are two terms, module and section, which have special 
meanings when used to describe relocatable code. When one or 
more source files are assembled the resulting relocatable code is 
called a module. That is, each time the assembler is used to 
generate relocatable code it produces a single module. The 
module may contain one or more sections. It may contain a 
program section, a data section, and one or more common 
sections. 



ASMBLE/Z can produce relocatable modules. -These modules are 
loaded' into memory by the linker. Taken, together, these two 
programs (the assembler and the linker) provide very powerful 
facilities for the programmer: 

I) Source code (in a SRC file), written with all address 
references represented by symbols, can be assembled into a 
relocatable module, which is then sent to the linker. The 
linker can be told to load the module at nearly any address; 
that is, the module is relocatable. The relocatable modules 
require relatively little processing by the linker as 
compared to the processing the assembler performs on a 
source file, and therefore the relocation of a module can be 
accomplished in very little time. 

2'* Several relocatable modules can be loaded by .the linker, into 
different locations' in memory? the linker determines the 
absolute addresses so that all the code is loaded properly, 
each relocatable module going into the next memory location 
left free by the last relocatable module. 

3) Convenient means are provided to allow various relocatable 
modules to make references to each other. This means that 
there can be symbols in a source file which only reference 
other- places in the same source file (this means that they 
can be duplicated in other source files you wish to link 
without conflict) and, on the other hand, certain labels can 
be specified as entry point symbols or external symbols 
(see ENTRY and EXTERNAL section) , allowing different source 
files to have common symbolic references. If in one source 
file a certain symbol is specified as an entry point, then 
references to that symbol in other- modules - if they are 
declared as external symbols - will be performed correctly. 
Thus, modules can call subroutines and reference data in 
other modules . 

4) Also available are common sections. These are typically 
used to transfer data between different modules. Each 
relocatable module may have up to 1? of these, distinguished 
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by their name - any symbolic label desired, or a blank 
label, is permitted. When the various source files are 
assembled into relocatable modules and are then loaded into 
memory by the linker, these common sections are grouped 
together from all the different modules according to name. 
The common sections are overlayed? the linker assumes that 
any common sections with the same name (all blank commons 
are assumed to have the same name) represent identical 
locations in memory. This allows the different modules tc 
have common tables of data, so that when one module calls s 
subroutine in another, for instance , it can pass s 
reference to a table in a common area that the other 
subroutine can use to process data. 

5) Other named sections are provided : PRGG, ABS, and DATA." Th« 
PROG (program) is the default section which is assumed if nc 
section label is given. ABS provides the facility for 
writing absolute code that will not be relocated, when th?.- 
is desired. DATA is provided so that you may, if y. 
desire, locate the data section of a program in a differ©!. 
area than the instruction area? as might be necessary if 
the program is to be burned into a PROM. 

5) A facility of the linker that provides even more programming, 
power is the ability to construct library modules. These 
are produced in much the same way as a normal relocatable- 
modules - by writing source files r assembling them tc 
produce relocatable modules, and linking them - except that 
in the librarian mode, the linker produces- a library file a- 
output instead of executable absolute binary code. This 
library file contains relocatable modules, but provides s 
powerful additional feature. You typically load one or more 
relocatable modules with the linker P followed by a library 
file; the linker treats the library file in a special way, 
in that, as it encounters each module in the library file, 
it checks to see if any references have been made to the 
entry point symbols in that library module. If the linker 
finds no requests for these entry points, it skips that 
module of the library file without loading it, and moves or' 
to the next. On the other hand, if the linker finds that it 
needs one or more entry points in the library file it loads 
that module . 

These features together provide a very flexible Z-30 assembly 
language environment. The operation of each facility is 
explained in detail in later sections of this manual. 
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MODULE SECTIONS 

A relocatable module may contain up to eighteen different 
sections to allow you to store absolute, program, data, and 
common code. Each section has its own program counter. At the 
beginning of an assembly all program counters are set to zero. 
As the assembler generates code in one section the appropriate 
program counter is incremented to keep track of the location of 
each byte of code. As labels are generated they are marked as 
belonging to that section of code. When you- change from one 
section to another (you may do this as often as you like) the 
assembler saves the program counter from the last section and 
loads the program counter for the new section. Later on, if you 
switch back to the previous section again the program counter 
points to the next available byte in that section and the code 
assembly continues from where it left off. 

For example, if you generate three bytes in section one they are 
stored at' locations 00, 01, and 02 in section one's base. Then 
you generate two bytes in section two. They are stored at 
locations 00 and 01 in section two's base. Now., if you generate 
another byte in section one it is stored at location 0"* in 
section one's base. 



The eighteen different sections are called by name. The first 
three sections are called ABS, PROG,- and DATA (when -the assembler 
starts it specifies PROG as the default section). The remaining 
fifteen sections are called COM. 2ach COM section has a user 
defined name. The names are only significant in the first eight 
characters (the same as symbol names). One COM section may be 
unnamed. It is referred to as blank common. You may change to 
any section by giving its name as an instruction. For example: 

DATA Start the DATA section. 

PROG Start the PROG section. 

COM TABLE Start a common section named TABLE. 

COM Start a blank common section. 

DATA Continue in the DATA section. 

The assembler treats all eighteen sections alike. That is, it 
maintains a separate program counter for each section and marks 
all labels generated in a given section as belonging to that 
section. The linker, on the other hand, treats the sections 
differently. Absolute code from the ABS section is always loaded 
into absolute memory as specified (that is, it is not 
relocated). If several modules are being linked together the 
PROG and DATA sections from the various modules are loaded into 
different reg-ions of memory. All common sections of a given name 
are loaded into the same locations. For example, assume- the 
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linker loads two modules which each contain a PROG section and a 
blank common section. When the program runs, the part of the 
program in the first module's PROG section might store a" data 
byte in the first location of blank common. The part of th-> 
program in the second module's PROG section might load the same 
byte from the first location of blank common. 

You should use a little caution when generating code in ABS and 
COM sections. This code may be overwritten by other modules 
which are linked together. For example, one module may 
initialize a table in a common section in one way and another 
module may initialize the table in the same common section in 
another way. The order in which the modules are specified to the 
linker determines which initialization is overwritten and which 
one remains loaded. It is usually better to simply reserve space 
in all common sections with the DS instruction and initialize 
them at run time. 

You may also change sections with an ORG instruction. The type 
of argument (that is, the section in which the argument was 
defined^ determines the new section. For example, if BLOTZ is 
the name of a location in the data section, then: 

ORG BLOTZ +?. 7 

tells the assembler to generate code in the data section 27 bytes 
beyond BLOTZ-. 

You should be very careful about using the ORG instruction in 
programs that use external symbols (see ENTRY and EXTERNAL 
section, below) . The assembler generates all references to an 
external symbol of a .given name as a linked list. The last 
reference points to the previous reference, etc. The list must 
be intact for the linker to properly resolve the external 
symbol. If you rewrite a section of code with the ORG 
instruction (for example, ORG $-20> and an external reference is 
overwritten, then the linked list is broken and the linker will 
do unpredictable things. This cannot happen if you use the PROG, 
and DATA instructions. 



Referencing external symbols in a common section is also a 
dangerous practice because the linker overlays all common 
sections of the same name. Tn general, it is not a good practice 
to store any executable code in common sections. 
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ENTRY and. EXTERNAL 



Modules may communicate with each other through common sections 
as explained in the previous paragraphs. They may also 
communicate by specifying various locations as entry points in 
one module, and as an external symbol in another module. The 
linker matches up all the entry point symbols in one module with 
all the external symbols in other modules it is linking. 

Entry points and external symbols are treated as sixteen-bit 
address values. Therefore, if BLOTZ is an external symbol you 
may refer to it in a statement such as LXI H, BLOTZ, but you may 
not refer to half of an external address in a statement such as 
MVI A,BL0TZ/25f. 



A module may specify certain locations as entry points, in which 
case they must be defined in the same module. The module may 
also specify certain locations as external to that module. These 
locations must not be defined in that module but will be defined 
later in the linking operation. For example, suppose you are 
writing a navigation module . which uses trig functions 
(subroutines) in another module. In your navigation module you 
might write : 



EXT 


SIN, COS, TAN 


LHLD 


' ANGLE 


CALL 


SIN 


• 

LHLD 


ANGLE 


CALL 


COS 



define SIN, COS, TAN as externals 



In the trig function module you might write: 



ENTRY SIN, COS, TAN 
SIN: PUSH H 



; define SIN, COS, TAN as entry points 



COS: 



POP H 

RET 

PUSH H 
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When _.the linker links these modules it first loads them into 
memory and determines the actual ^locations of the three entry 
points, SIN, COS, and TAN, in the. trig function module. Then it 
goes through the navigation module and sets the actual addresses 
for the three external symbols. 



NAME 

Every relocatable module has a name. The name is initially set 
to the first eight characters of the output file (REL file) 
name. You may change the module name at any time with the NAME 
instruction. You may change the name as often as you like but 
only the last name specified is given to the output file. For 
example : 

NAME TRIG 
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LIBRARY 

Related relocatable modules/ usually subroutines, may be 
collected together in a single file called a library. Various 
modules from the library are selectively loaded by the linker 
after the main routines (modules) of a program are loaded. That 
is, the main routines of a program usually need to use 
subroutines which are found in the library. The main routines 
are loaded first. Whenever a main routine needs a library 
subroutine it declares the subroutine's entry point to be 
external to the main routine. The linker places the subroutine 
entry point name (symbol) in the external symbol table. After 
the main routines have been loaded (and several symbols have 'been 
placed into the external symbol table) the linker selectively 
loads the library. It compares entry point symbols from each 
library module with symbols in the external symbol table. If it 
finds a match, that is, if it finds that one or more entry points 
in a library module will resolve external symbols, it loads the 
module. If it does not find a match it skips the module (since 
it does not need it) and goes on to the next one. 

A module in a library may contain external symbols as well as 
entry point symbols, that is, the module may require the services 
of one or more other modules in the library. For example, in the 
TRIG library, the TAN and COT modules calculate the tangent and 
cotangent of an angle. These modules make use of the identity: 
TAN(a)=SIN(a)/COS(a) f and call the SIN and COS modules to 
calculate the sine and cosine of an angle. The TAN and COT 
modules also call the DIV module to perform the division. 

A library should load all necessary modules (and no unnecessary 
ones) in one pass. This means that a module should appear in a 
library after it has been referenced by an external symbol in 
other modules. That is, external symbols should forward 
reference the modules in which the symbols are defined (as entry 
points). For example, the COT module should come before the TAN 
module because it uses the TAN function in its calculation 
(COT(a) =1/TAN (a) ) . The TAN module should come before the SIN and 
COS modules. The SIN and COS modules do not reference each other 
and thus may appear in any order. Everything references the DIV 
module so it should come last. With the library put together in 
this order the required modules (but no more) will be loaded no 
matter what the main routine may require. 

Sometimes it is not possible to arrange library modules so that 
their external symbols only reference in a forward direction. 
For example, suppose that some subroutines in module A reference 
some subroutines in module 3 and some other subroutines in module 
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B reference some subroutines in module A (fold your hands and 
think about it) . There are several things you can do to rectify 
this situation: You may decide, that module A and module B should 
be combined into one larger module thus eliminating the cross 
referencing. Or you may find that you can eliminate the cross 
referencing by moving some subroutines from one module to the 



other. 



However, it may not always seem possible to eliminate the cross 
referencing. In that case you may put two copies of module A 
into the library, one before and one after module B. If the main 
routine needs module A it is loaded the first time it is 
encountered in the library. Module A then references module B 
which is loaded next. When the second copy of module A is 
encountered in the library it is skipped because all external 
references to it have already been resolved (resolved external 
symbols are removed from the external symbol table) . On the 
other hand, if the main routine needs module B it is loaded first 
followed by module A. In either case both modules are" loaded, 
only their order in memory is different. 

It is a good idea to put non-modifiable execution code (pure 
code) in PROG sections and modifiable data in DATA sections. 
This is true in both main routines and in libraries. If you ever 
want to burn a program into a PROM you simply tell the linker to 
load all PROG sections into the PROM region of memory and to 
allocate space in read-write memory for . the data. For example^ 
suppose you have a pair of text buffering subroutines: one 
subroutine gets a complete line of text from the keyboard and 
puts it into a line buffer, the companion routine returns the 
next sequential character from the line buffer each time it is 
called. These two subroutines would be placed in the PROG 
section of the module and the line buffer would be placed in the 
DATA section. 
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PROGRAM COUNTER 

The assembler evaluates each line of source code and generates 
one or more bytes of machine code. The machine code will be 
loaded into sequential memory locations later on. The assembler 
keeps track of the current memory address in its program 
counter. This is a 16 bit counter which starts with a value of 
zero. Each time the assembler generates a byte of machine code, 
it increments the program counter. Since each byte is stored in 
a location whose address is one greater than the address of the 
last byte, the value of the program counter and the value of the 
current memory address always agree. This one-to-one 
correspondence is, of course, altered when a relocatable module 
is loaded by the linker. 

The program counter may be read with the symbol $. In the 
following examples I represents the left edge of the source 

line. 

I HERE EQU $ HERE is set to the current value of the 

program counter. 

There are actually eighteen different program counters; one each 
for the absolute, program, and data sections, and one for each of 
the fifteen different common sections. Every time a new section 
is entered the program counter for the last section is saved and 
the program counter for the new section is loaded. This means 
that you can generate code in a program section, for example, 
then switch to the data section, generate some data code, then 
switch back to the program section and continue generating code 
from where you left off. 
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SYMBOLS 



A symbol represents a number or an instruction. It starts with i 
letter, dollar sign, percent sign, dot, number sign, o: 
underscore and may contain any of the following characters: 

0-9 Numbers 

A-Z Upper case letters 

a-z Lower case letters 

$ Dollar sign 

% Percent sign 
Dot 

# Number sign 

_ Underscore 

Here are some examples of symbols and non symbols: 

$ A symbol may start with $. 

ABC A symbol may start with a letter. 

X27 A symbol may contain numbers. 

4SALE A symbol must not start with a number. 

D~3 A symbol must contain only alphanumeric 

characters, $, %, ., #, . 

When a symbol is evaluated ' all lower case . characters an 
translated into upper case characters. The following symbols al: 
have the same value: 

mov 
Mov 
MOV 

When the assembler extracts a symbol from a source line, it pick* 
up characters until it has a total of eight characters or until 
it reads a non-symbol character. Any symbol characters beyom 
the first eight are ignored. Here is a list of symbols as the* 
appear in a source line and as they are extracted by th< 
assembler : 



abcl23 


ABC123 


A,B 


A 


VALUE 12 


VALUE 1 


VALUE 13 


VALUE 1 



In the first example the lower case characters are translates 
into upper case characters. In the second example the symbol i« 
A and is terminated by the comma. In the third and fourtJ 
examples only the first eight characters are significant in thi 
symbol. The rest are ignored. Notice that VALUE12 and VALUE!: 
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are treated as the same symbol. 



LISTING 



The first line on each page of the listing is the program header 
line. It is made up of the first line from the first source file 
(with leading semicolons, spaces, and tabs stripped off) , the 
current date, the assembler version number, and the current 
page. The remainder of the page contains the program listing. 

Each listing line contains the address of the first byte of code 
in the line, up to four bytes of code, and the source text which 
generated the code. 

The DB and DS instructions may generate more than four bytes of 
code. In this case the extra code is listed on subsequent 

1 ines . 

Some instructions do not generate any executable code (for 
example, EQU, IF, END, etc). The address is left blank in these 
lines to indicate that no code is generated. However, many of 
these instructions have a numeric value associated with them 
which is listed.' 

Addresses associated with relocatable (non absolute) code 
sections are followed by various characters to indicte the code 
section in which they were generated. The characters are as 
follows : 



t 


PROG 


It 


DATA 


* 


COM 


# 


EXT 



Macro definitions are noted with a minus sign following the 
address. Macro expansions are noted with a plus sign following 

the address. 



Macro definitions, macro expansions, and conditional statements 
(IF) may be nested (a macro expansion may call another macro 
expansion, for example). The source text is indented two spaces 



for each level of nesting. 
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Sixteen-bit values are listed with their most significant byt? 
first for readability, but they : : are stored with their least 
significant byte first. For example, the following instruction 

LXI . B,1234H 

is listed as: 

0000 01 1234 LXI B,1234H 

and generates the following code: 

01 
34 
12 

The symbol table follows the program listing. The first line 
contains information about the assembly (number of errors 
detected, number of symbols generated, and amount of unused space 
in memory) . If the program generated any macros the next line 
contains information about the macros (number of characters 
stored and number of macros generated). The next line contains 
information about section sizes (size of absolute, program, and 
data sections) followed on subsequent lines by the names of ali 
common sections and their sizes (blank common is listed as 
* *) . The symbols follow on the next page in colum: 
alphabetized order followed by their sixteen bit value writter 
as four hex characters. If a value is a relocatable address it 
is followed by the -corresponding . relocation character (', n , *, 
or #) . Macro name's are also listed in the table followed by the 
letter M in place of the value. 
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SOURCE LINE FORMAT 



A source line consists of. a label field, ah instruction field, an 
argument field, ^ and a comment field. -Each line may contain none, 
any, or all of these fields. This is what a source line looks 
like: 

[LABEL INSTRUCTION ARGUMENT(S) COMMENT 



LABEL FIELD 



A label is a symbol which begins in the first column. If a 
symbol does not begin in the first column it is not a label. 
This means that you may have only one label on a line since there 
is only one first column on a line. It also means that you may 
not indent labels. 

I BOB BOB is a label. 

f CHARLIE CHARLIE is not a label; it is indented. 

A label may be terminated with any non symbol character, that is, 
a space, tab, colon, etc. 

I MULT . Label ends with a space. 
I'DIV: Label ends with a colon.- 

The symbol used in a label is given the current value of the 
program counter. Since the value of the program counter is 
equivalent to the current memory address, each label is equal to 
the memory address of the first byte in its line. For example, 
suppose that the current value of the program counter is 123. 

IMIX: MOV A,B 
[MATCH: MOV C,D 

MIX is given the value 123 since the value of the program counter 
is equal to 123 at the beginning of the first line. The 
instruction MOV A,B generates one byte of code. This increments 
the program counter. At the beginning of the second line it has 
a value of 124 so MATCH is given a value of 124. In the case of 
relocatable code, the assigning of actual memory addresses to 
labels is deferred until the linker loads the code. 
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INSTRUCTION FIELD 

An instruction is a symbol which does not begin in the first 
column. The assembler tells the difference between labels and 
instructions by noting whether or not the symbol starts in the 
first column.* The instruction symbol may only be terminated with 
a space, tab, semicolon, or carriage return. 

ITOP: RAL TOP is a label. RAL is an instruction. 

I PCHL PCHL is an instruction. 

J It does not start in the first column. 

|L26:CMA L2fJ is a label terminated by a colon. 

I CMA is an instruction. 
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ARGUMENT FIELD 



Some instructions require one or more arguments. The arguments 
are separated from the instruction by one or more tabs or 
spaces. If the instruction requires more than one argument the 
multiple arguments must be connected by commas and must have no 
intervening tabs or spaces. The only exception to this rule is 
the use of the arithmetic operator NOT. It must be separated 
from the argument it modifies by a tab or a space. Here are some 
examples of single arguments: 

COUNT A symbol 

C Either the symbol C or register C 

f G* A one byte tex.t string 

' AB' A two byte text string 

'Time' A multi-byte text string 

36 • A number 

NOT TRUE An arithmetically modified symbol 

TOP+2 Another arithmetically modified symbol 

Here are some examples of instructions which require single and 
multiple arguments: 



POP 


D 


AD I 


100 


SUI 


PVAL 


MOV 


C,A 


LXI 


H,ADDR 


LXI 


B, »XY f 



In the first example the instruction POP requires a single 
argument which must be a register name. The instructions in the 
second and third examples require a single argument which may 
have any eight bit value. 100 is used as the value of the 
argument in the second example; ' the value which PVAL represents 
is used as the argument value in the third example. In the 
fourth example the MOV instruction requires two arguments which 
must be register names. The arguments are separated by a comma. 
The instructions in the last two examples require two arguments. 
The first argument must be a register name. The second argument 
may have any 16 bit value. The value of ADDR is used as the 
value of the argument in the fifth example; the 16 bit value of 
the text string - XY is used as the argument value in the last 
example . 
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COMMENT FIELD 



Any line of source code may contain a comment. The comment is 
optional. It is just a place for you to make a remark about the 
source code (or anything else, for that matter). The comment 
field usually contains a running commentary on the operation of 
the program. 



A comment is separated from the instruction or arguments by a 
tab , a space, or a semicolon. If a line contains nothing but a 
comment field the comment must start with a semicolon or an 
asterisk. Here are some examples of source lines with comments. 



MOV 
CMA 
MOV 
This line 



A,B This is a comment. 

; This comment starts with semicolon 
D,A; This comment is separated by semicolon, 
contains only a comment. 
; So does this one. 
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MACROS 



A macro is a named collection of" one or more lines of code. 
After the macro has been defined , it . may be inserted into a 
program one or more times simply by typing the macro's name in 
place of an instruction. '■" ' See the ASSEMBLER INSTRUCTION section 
for more detailed information about macros. 

A macro is defined by the instruction MACRO. It must have a name 
which starts in column one. The body of the macro follows on 
subsequent lines. The end- of the macro definition is indicated 
by the instruction ENDMAC. 



FLIP: MACRO 

MOV A,M 

CMA 

MOV M,A 

ENDMAC 



DEFINE A MACRO CALLED FLIP 

GET A BYTE. 

COMPLEMENT IT. 

REPLACE IT. 

END OF MACRO DEFINITION. 



This macro may be 
an instruction. 



called in a program by using the name FLIP as 



I LXI H f ADDR ; POINT TO A MEMORY LOCATION. 
I FLIP ; COMPLEMENT ITS CONTENTS. 

When the program is assembled, the macro in the preceding example 
is expanded as follows. 



LXI 
MOV 
CMA 
MOV 



H , ADDR 
A,M 

B,M 



POINT TO A MEMORY LOCATION 
GET A BYTE. 
COMPLEMENT IT. 
REPLACE IT. 



Notice that the comments in the macro definition are stored with 
the macro text and appear in the listing when the macro is 
expanded. . If your program defines quite a few macros, a lot of 
storage space may be taken up by comments. You can save this 
space by starting each comment with two semicolons. This 
prevents the comment from being stored. 



COM: MACRO 

MOV A r M 
MOV M,B 
ENDMAC 



THIS COMMENT IS STORED. 

THIS COMMENT IS NOT. 
END OF MACRO DEFINITION. 



This macro is expanded as follows: 



MOV 
MOV 



A,M 
M f B 



; THIS COMMENT IS STORED. 
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A macro* may be defined with dummy arguments which are replaced 
with real arguments when 'the ■ macro is called later in the 
rogram. The dummy arguments are listed on the first line of the 
macro as arguments . separated by commas. Each time a dummy 
argument is encountered in the body of the macro, it is replaced 
with a numbered marker. 



When the macro is called, the real arguments are given on the 
call line as arguments separated by commas. The first real 
argument replaces every occurrence of the first marker in the 
macro body, the second replaces the second, etc. If there are 
too many real arguments the extras are ignored. If there are not 
enough real arguments the missing ones are treated as null 
arguments, that is, arguments without any characters in them. 



OUTPUT :MACRO 
LDA 
OUT 
ENDMAC 



PORT,ADDR; DEFINE MACRO CALLED OUTPUT. 



ADDR 
PORT 



GET CONTENTS OF MEMORY LOCATION. 
TRANSMIT TO OUTPUT PORT. 
END OF MACRO DEFINITION. 



The macro is called as follows 



! OUTPUT 27H,DATA? TRANSMIT A BYTE FROM DATA TO OUTPUT PORT 27 

It is expanded like this: 

I LDA DATA ; GET CONTENTS OF MEMORY LOCATION.. 
! OUT 27H ; TRANSMIT TO OUTPUT PORT. 

The dummy arguments may occur anywhere in the macro body, 
including the label and instruction fields. 

jMACK: MACRO LAB , INS , ARG1 , ARG2 
I LAB: INS ARG1,ARG2 
I ENDMAC 

This macro is called as follows: 

I MACK ABC1,M0V,A,M 

It is expanded as follows: 



ABC1: MOV 



A,M 



Dummy symbols are treated like ordinary symbols. They must start 
with a letter, $, ., %, #, or . Only the first eight characters 
are significant. However, the arguments which replace the 
markers when the macro is expanded may contain any number of 
characters including quoted commas. 



- 27 - 



ASMBLE/Z 



A dummy argument may be concatenated with text in the macro body 
by using the 1 as a concatenation character. Whenever ! 
immediately precedes or follows a dummy symbol in the macro body, 
the ! ' and the dummy symbol are both replaced by the marker, 
without any intervening space. When the macro is later expanded 
the marker is replaced by a real symbol. 



TEXT: MACRO 
T ! TAG : DB 

ENDMAC 



TAG, TXT 
TXT,0 



This macro is called as follows: 



TEXT l,"Hi there, boys and girls" 

TEXT 2, "This is Uncle Fink" 



It is expanded as follows: 



Tl: 
T2: 



DB 

DB 



"Hi there, boys and girls", 
"This is Uncle Fink",0 



One macro definition may contain another macro definition. The 
dummy arguments apply to all the macro definitions. The text for 
the inner (contained) macro definition is modified and stored 
inside the outer macro body. 



OUTER :MACRO 

LDA 
INNER:MACRO 

AD I 

ENDMAC 

STA 

ENDMAC 



ARG1,ARG2? DEFINE OUTER MACRO. 
ARG 1 
ARG3 
ARG 3 



ARG 2 



DEFINE .INNER MACRO.. 

END OF INNER MACRO DEFINITION. 

END OF OUTER MACRO DEFINITION. 



At this time OUTER has been defined but INNER has not. A call, to 
INNER results in an error message. INNER is defined when OUTER 
is called and expanded. 

! OUTER HERE, THERE 

It is expanded as follows: 

; DEFINE INNER MACRO. 

,• END OF INNER MACRO- DEFINITION . 

Now INNER has also been defined. It can be called as follows: 
I POINT: INNER 34 



I LDA 


HERE 


1 INNER: MACRO 


ARG3 


i ADI 


ARG 3 


I ENDMAC 




1 STA 


THER 
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Notice that the label POINT has been placed in front of the .macro 
call. It is expanded as follows: 

1 ADI 34 

Finally, a macro may contain a. call to another macro. In fact, 
macro expansions may be nested to sixteen levels. 

I NEST: MACRO PLACE 

I LDA PLACE 

I INNER 123 ; NESTED MACRO CALL. 

I STA PLACE 

I ENDMAC • 

It is called as follows: 

I NEST BOPPER 

This is expanded as follows: 



LDA 


BOPPER 


ADI 


123 


STA 


BOPPER 
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ARGUMENT FORMAT 



Each -argument may be made up of any combination of user defined 
symbols, numbers, or quoted character strings. They may, be 
combined by + (add) , '- (subtract or negate) , * (multiply) , / 
(divide) , and & (logical and); Any argument may be preceded with 
the word NOT (complement) . The arithmetic procedures are carried 
out from left to right. No parentheses are allowed. For 
example, 1+2*3 is evaluated as 9, not 7. Arithmetic symbols may 
not be combined. For example, SYM1&N0T SYM2 causes an error. To 
prevent the error, divide the operation into two lines. The 
first line is NSYM2 EQU NOT £YM2. The second line contains 
SYM1&NSYM2. 
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RELOCATABLE SYMBOL ARITHMETIC 



Absolute symbols may be used in all arithmetic operations. For 
example, the following operations are all valid: 

ABS 

OFFSET EQU 27 

LDA S+OFFSET 

STA TABLE-OFFSET 



TABLE: DS 100 

Relocatable symbols may be used in some arithmetic operations but 
not in others. A constant (absolute) symbol may be added to or 
subtracted from a relocatable symbol. The result of the 
operation belongs to the same section as the relocatable symbol. 
A relocatable symbol may not be multiplied, divided, anded , or 
NOTed . 

PROG 

LDA TABLE-3 Valid 

LXI • H, TABLE/4 Not valid 



TABLE: DS 100 

A relocatable symbol may be subtracted from another relocatable 
symbol of the same section. The result is the absolute 
difference between the two symbols. The two symbols may not be 
in different sections because the addresses represented by the 
symbols are not known until the module is linked. 

DATA 
TABLE: DB 'A* 



DB % Z X 

LENGTH EQU TABLE-S ; NUMBER OF BYTES IN TABLE 
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The assembler evaluates an expression from left to right 
following example the first two terms are relocatable 
result of the subtraction is an absolute number 
divided by another absolute number. 



In- the 

but the 

which may be 



DATA 
TABLE: DW 



BLOTZ 



DW 
LENGTH EQU 



BLINTZ 

TABLE-S/2 ; NUMBER OF ADDRESSES IN TABLE 



An external symbol may not be used in any arithmetic or logical 

operation . 

EXT BLOTZ 

LDA BLOTZ Valid 

STA BLOTZ+3 Valid 

LHLD 3-BLOTZ Not valid 
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STRINGS 



A quoted character string must start with either a single quote 
(') or a double quote ('*). The quote character is used as a 
delimiter to determine the end of the string. All characters in 
the string up to but not including the second delimiter are 
evaluated. Both delimiters must be the same. If the second one 
is missing, all remaining characters up to the end of the line 
are considered part of the quote string. For example, DW ' AB' is 
evaluated as 4142H. 



NUMBERS 

Some instructions require a single byte argument. If the value 
of the evaluated argument requires more than one byte to express f 
an error message is printed. For example, 2^0 is evaluated a;- 
104H. MVI A, 260 gives an error message. The exception to this 
rule is a number whose high byte is OFFH, such as -2 (OFFFEH) . 
This number returns only the low byte without an error message. 

Numbers may be represented in binary, octal, decimal, or hex 
notation. All numbers must start with a decimal digit (0 - 9) . 
That is, a hex number that starts with a letter should have a 
zero before it,, or it will be interpreted as a symbol (OFFH). If 
the ' number is not a decimal number it must end with a letter to 
indicate the notation. 

TYPE DIGITS TERMINATION 



or nothing 



Binary 





- 


1 


B- 




Octal 





— 


7 





or 


Decimal 





- 


9 


• D 


or 


Hex 





- 


9, 


H 






A 


— 


F 
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Here are some examples of proper numbers: 



1011001B 


Binary 


13S7Q-, .-- 


Octal 


22450 


. 


2468. 


Decimal 


1234D 




99 




3B9CH 


Hex 


OFFFH 





ASMBLE/Z - 34 - 



RELATIVE JUMPS 



The relative jump instructions require an argument which is 
evaluated as a 1<5 bit address. The difference between the 
address and two plus the current value of the program counter is 
used as the eight bit signed relative jump offset. If the offset 
cannot be expressed by an eight bit number, that is, if the 
address is farther than plus or minus 127 bytes from the prograrr 
counter plus two; the jump cannot be made and an error message is 
printed. A relative jump may start and end in the same 
relocatable section but it may not jump from one section tc 
another. 
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REGISTER NAMES 

Single (eight bit) registers have the following names: 

A 
. - ■ B 
C 
D 
E 
H 
L 
M 

d(IX) 
d(IY) 

I Interrupt vector register 
R Memory refresh register 

M is a memory location whose address is in the HL register pair, 
that is, HL points to register M. Memory locations d(IX) and 
d(IY) are locations whose address is the contents of the IX or IY 
register added to d where d is a signed eight bit number. The 
symbol d can be evaluated as a signed eight bit number. It may 
also be omitted' altogether . 

Double (16 bit) registers have the following names: 

3 BC pair 

D DE pair ' 

H HL pair 

PSW Processor status word, A and flags 

SP Stack pointer 

IX Index register X 

IY Index register Y 

P may be substituted for PSW, S may be substituted for SP, and X 
or Y may be substituted for IX or IY in any instruction. 
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MACHINE INSTRUCTIONS 



This section contains the machine instructions organized into 
logical groups. They generate code which tells the computer wha j . 
to do. The first line of the description of each group, of 
instructions is an example of the proper use of an instruction in 
the group. 
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JUMP, CALL 

Format: JMP BL0T2 

The jump and call instructions require an argument which is 
evaluated as a 16 bit address. 

JMP Jump. 

JNZ Jump if non-zero. . 

JZ Jump if zero. 

JNC Jump if no carry. 

JC Jump if carry. 

JNV Jump if no overflow. 

JV Jump if overflow. 

JPO Jump if parity is odd. 

JPE. Jump if parity is even. 

JP Jump if positive. 

JM Jump if minus. 

JNV generates the same code as JPO. JV the same as JPE. 

JR Jump relative. 

JMPR Jump relative. 

JRNZ Jump relative if non-zero. 

JRZ Jump relative if zero. 

JRNC jump relative if no carry. 

JRC Jump relative. if carry.. 

DJNZ Decrement B and jump relative if B <> 0. 

Format: CALL BLOTZ 

CALL Call a subroutine. 



CNZ 


Call 


if 


non-zero . 


CZ 


Call 


if 


zero . 


CNC 


Call 


if 


no carry. 


CC 


Call 


if 


carry. 


CNV 


Call 


if 


no overflow. 


CV 


Call 


if 


overflow. 


CPO 


Call 


if 


parity is odd. 


CPE 


Call 


if 


parity is even 


CP 


Call 


if 


positive. 


CM 


Call 


if 


minus . 



CNV generates the same code as CPO. CV the same as CPE. 
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RETURN 



Format: RET 



The return instructions do not require an argument. 

RET Return from a subroutine. 

RNZ Return if non-zero. 

RZ Return if zero. 

RNC Return if no carry. 

RC Return if carry. 

RNV Return if no overflow. 

RV Return if overflow. 

RPO Return if parity is odd. 

RPE Return if parity is even. 

RP Return if positive. 

RM Return if minus. 

RNV generates the same code as RPO. RV is the same as RPE 

RETI Return from interrupt. 

RETN Return from non-maskable interrupt. 
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RESTART 



Format: RST 3 



The restart instructions require an argument which represents a 
number between zero and seven. 

RST n Restart at location n*8 where n is a value from 0-7 



ASMBLE/Z - 40 - 



ACCUMULATOR 



Format: ADI 2"? 



The accumulator immediate instructions require an argument which 
is evaluated as eight bits. These instructions modify all 
flags. All instructions except CPI leave the result of the 
operation in the A register. The CPI instruction does not change 
the A register. 

ADI Add immediate. 

ACI Add immediate with carry. 

SUI Subtract immediate. 

SBI Subtract immediate with borrow. 

ANI AND immediate. 

XRI Exclusive OR immediate. 

ORI OR immediate. 

CPI Compare immediate. 



Format: ADD 3 (IX) 

The accumulator register instructions require an argument which 
is a single register name, A, B, C, D r E, H r L, M, d(IX) , or 
d(IY). These instructions modify all flags. All instructions 
except' CMP leave the result of the operation in the A register. 
The CMP instruction does not change the A register. 

ADD Add register to A. 

ADC Add register to A with carry. 

SUB Subtract register from A. 

SBB Subtract register from A with "borrow. 

ANA . AND register with A. 

XRA Exclusive OR register with A. 

ORA OR register with A. 

CMP Compare register with A. 



- 41 - ASMBLE/2 



INCREMENT, DECREMENT 



Format: INR A 



The single register increment and decrement instructions require 
an argument which is a single register name, A, B, C, D f E, H, L, 
M p d(IX), or d(IY). All flags except carry are modified. 

INR Increment the register. 
DCR Decrement the register. 



Format: INX H 



The double register increment and decrement instructions require 
an argument which is a double register name, B, D, H, SP, IX, or 
IY. No flags are modified. 

INX Increment the register pair. 
DCX Decrement the register pair. 
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DOUBLE ADD, SUBTRACT 



Format: DAD B 



The double register add and subtract instructions require an 
argument which is a double register name, B, D, H, or SP. DADX 
accepts IX instead of H as an argument and DADY accepts IY 
instead of H as an argument. The DADC and DSBC instructions 
modify all flags. The other instructions modify only the carry 
flag . 

DAD Add 'the register pair to HL. 

DADC Add the register pair to HL with carry. 

DSBC Subtract the register pair from HL with borrow. 

DADX Add the register pair to IX. 

DADY Add the register pair to IY.- 
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LOAD, STORE 
Format: LDAX B 



The LDAX and STAX instructions require an argument which is a 
double register name, B, or D. 

LDAX Load A from location pointed to by register pair. 
STAX Store A in location pointed to by register pair. 



Format: LDA BLOTZ 



The load and store direct instructions require an argument which 
is evaluated as a 16 bit address. 



LDA 


Load A. 


LBCD 


Load BC. 


LDED 


Load DE. 


LHLD 


Load HL. 


LSPD 


Load stack pointer. 


LIXD 


Load IX. 


LIYD 


Load IY. 


STA 


Store A. 


SBCD 


Store BC. 


SDED 


Store DE. 


SHLD 


Store HL. 


SSPD 


Store stack pointer. 


SIXD 


Store IX. 


SIYD 


Store IY. 
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PUSH, POP 



Format: PUSH H 



The push and pop instructions require an argument which is a 
double register name, B r D, H, PSW, IX, or IY. 

PUSH Push the register pair onto the stack. 
POP Pop the stack into the register pair. 
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INPUT, OUTPUT 



Format: IN 5 



The input and output instructions require "an argument which is 
evaluated as an eight bit port number. These instructions do not 
modify any registers. 

IN Move data from the input port into A. 
OUT Move data from A to the output port. 



Format: INP D 



The input register and output register instructions require an 
argument which is a single register name, A, B, C, D, E, H, L, or 
M. The OUTP instruction does not modify any flags. The INP 
instruction modifies all flags except carry. The INP M- 
instruction only modifies the flags, not the memory location. 

INP Move data from the input port whose port number is 

in C into the register. 
OUTP Move data from the register to the output port whose 

port number is in C. 



Format: INI 



The input memory and the output memory instructions d.o not 
require an argument. The zero flag is. set if the B register, is 

carry flag is not affected. 



decremented to zero. The 



INI Move data from the input port whose port 
in C into M. Decrement B. Increment HL. 

INIR Do INI until B = 0. 

IND Same as INI except decrement HL. 

INDR Do IND until B = 0. 

OUTI Move data from M to the output port 
number is in C. Decrement B. Increment 

OUTIR Do OUTI until B = 0. 

OUTD Same as OUTI except decrement HL. 

OUTDR Do OUTD until B = 0. 



number is 



whose 
HL. 



port 
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MOVE, LOAD IMMEDIATE 



Format: MVI B,27 



The move immediate instructions require two arguments; a single 
register name, A, B, C f D, E, H, L, M r d(IX) , or d(IY) , and an 
argument which is evaluated as eight bits. The two arguments are 
separated by a comma. 

MVI Move the number into the register. 



Format: LXI H,BLOTZ 

The load immediate instructions require two arguments: a double 
register name, B, D, H f SP f IX, or IY, and an argument which is 
evaluated as 16 bits. The two arguments are separated by a 
comma . 

LXI Load the number into the register pair. 



Format: MOV A,B 



The move instructions require two arguments. Both are single 
register names, A, B, C, D, E, H, L, M, d(IX), or d(IY). The 
arguments are separated by a comma. The two arguments should not 
both be memory, that is, you can't say MOV M, (IX) . 

MOV Move second register into first register. 
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BLOCK MOVE, SEARCH 



Format: LDI 



The block move and compare instructions do not require an 
argument. The P/V flag is cleared to zero if BC is decremented 
to zero. The load instructions modify only the P/V flag. The 
compare instructions set the zero flag if the contents of A' equal 
the contents of M and also modify the' sign flag. These 
instructions do not change the carry flag. 

LDI Move contents of memory pointed to by HL into memory 
pointed to by DE. Increment DE and HL. Decrement 
BC. 

LDIR Do LDI until BC = . 

LDD Same as LDI except decrement DE and HL. 

LDDR Do LDD until BC = . 

CCI ' Compare A with M. Increment HL. Decrement BC. 

CCIR Do CCI until BC » or A » M. 

CCD Same as CPI except decrement HL. 

CPDR Do CPD until BC = or A = M. 
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BIT 



Format: BSET 3,M 

The bit set, reset, and test instructions require two arguments: 
an argument which represents a bit position between zero and 
seven, and a single register name, k, B, C, D, E f H, L, M f d(IX), 
or d(IY). The arguments are separated by a comma (bit number, 
register name) . Only the BIT instruction modifies any 
registers. The carry flag is not changed. 

BSET Set the bit in the register . 

RES Reset the bif in the register. 

BIT Copy the bit in the register into the zero flag. 
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ROTATE, SHIFT 



Format: RLC 



The rotate A instructions do not require an argument. They 
modify only the carry flag, 

RLC Rotate A left S bits. MSB into carry. 



Cy <— 7..0- <- 
RRC Rotate A right 8 bits. LSB into carry 



-> 7. .0 — > Cy 

RAL Rotate A p carry left 9 bits. MSB into carry 
RLA Same as RAL. 



- Cy < — 7..0 <- 

RAR Rotate A f carry right 9 bits. LSB into carry. 
RRA Same as RAR. 

i I. 

-> 7..0 — > Cy - 
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Format: RLCR D 



The rotate and shift instructions require an argument which is £ 
single register name, A, B, C, D, E, H, L, M f d(IX), or d(IY)< 
These instructions modify all flags. 

RLCR Rotate register left 8 bits. MSB into carry. 
See RLC. 

RLAR Rotate register left 9 bits.. MSB into carry. 
See RAL. 

RRCR Rotate register right 8 bits. LSB -into carry. 
See RRC. 

RRAR Rotate register right 9 bits. LSB into carry. 
See RAR. 

SLAR Shift register left 9 bits. into LSB. 

Cy <- 7..0 <- MSB into carry. 

SRAR Shift register right 9 bits. Sign into MSB. 

LSB into carry. 

I I 
-> 7. .0 -> Cy 

• SRLR Shift register right 9 bits. into MSB. 

-> 7..0 -> Cy LSB into carry. . . 



Format: RLD 

The rotate digit instructions do not require an argument. These 
instructions modify all flags except carry. 

RLD Rotate four LSBs of A left with M. 

I f 

A3. .AO M7. ,M4 M3. .MO 

1 I I I 

RRD Rotate four LSBs of A right with M. 

I I 

A3. .AO M7. .M4 M3. .MO 

I 11! 
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MISCELLANEOUS 



Format: CMA 



Several miscellaneous instructions do not require 
No flags are affected unless otherwise noted. 



an argument. 



CMA Complement accumulator. 

NEG Negate accumulator. All flags modified 

DAA Decimal adjust accumulator. All flags modified. 

STC Set carry. Only carry modified. 

CMC Complement carry. Only carry modified. 

NOP No operation. 

HLT Halt. 

EXAF Exchange A 1, flags 1 with A 2, flags 2. 

EXX Exchange BC 1, DE 1, HL 1 with BC 2, DE 2, HL 2. 

XTHL Exchange the contents of 

XTIX Exchange the contents of 

XTIY Exchange the contents of 

XCHG Exchange DE with HL. 

PCHL Load the program counter 

PCIX Load the program counter 

PCIY Load the program counter 

SPHL Load the stack pointer from HL. 

SPIX Load the stack pointer from IX. 

SPIY Load the stack pointer from IY. 

DI Disable interrupts-. 

EI Enable interrupts. 

LDAI Load A with I. Zero and sign flags modified. 

P/V flag gets contents of IFF. 

STAI Store A in I. 

LDAR Load A with R. Zero and sign flags modified. 

P/V flag gets contents of IFF. 

STAR Store A in R. 

IMO Set interrupt mode 0. 

IM1 Set interrupt mode 1. 

IM2 ' Set interrupt mode 2. 



the top of 


the 


stack 


with 


HL 


the top of 


the 


stack 


with 


IX 


the top of 


the 


stack 


with 


IY 


from HL. 










from IX*. 










from IY. 
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ASSEMBLER INSTRUCTIONS 



This section contains assembler instructions. They tell the 
assembler what to do. In some cases they generate machine code. 
The first line or lines of the description of each instruction is 
an' example of the proper use of the instruction. 
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MACRO 



Format: BLOTZ : MACRO REG 

SLAR -REG 
EN DM AC 



A macro definition requires the MACRO instruction with a label, 
zero or more lines of code which are stored as the body of the 
macro definition, and an ENDMAC instruction, which marks the end 
of the macro body. The line containing the MACRO instruction may 
also contain several, dummy arguments separated by commas. A 
macro definition may contain other macro definitions "(255 
maximum) and calls to other macros (15 maximum) . 

Once, a macro has been defined it may be called by using the macro 

name in place of an instruction. The code stored for that 

particular macro is recalled and entered in the program, 
character by character, and filiated. 

When the MACRO instruction is encountered, the "label is entered 
in the user's symbol table and marked as a macro. The dummy 
argument symbols are stored in a temporary symbol table. The 
code in the body of the macro definition is stored character by 
character in the macro storage space. Comments beginning with 
two semicolons, are not stored. ■ If a. symbol- in the body- is. 
encountered which matches one of the dummy argument symbols, a 
numbered marker is stored in the macro storage space instead of 
the symbol. If the symbol matches the first dummy symbol the 
marker is given the value one, if it matches the second symbol it 
is given the value two, etc. The exclamation point (!) is used 
as a concatenation character. If a dummy symbol in the body is 
preceded or followed by the concatenation character, the I is 
removed along with the dummy symbol when it is replaced by a 
marker. The macro definition may contain one or more embedded 
macro definitions. The dummy argument symbols are compared to 
symbols in all levels of the definition. All dummy symbols are 
replaced by markers. 

The line containing the macro call may also contain one or more 
arguments separated by commas. These arguments (actually 
character strings) are substituted for the markers in the macro 
body. The arguments may be any length (as long as they all fit 
on one line) , and may contain commas in quoted strings. The 
first argument string replaces every occurrence of the first 
marker, the second string replaces the second marker, etc. 
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DEFINE. BYTE, WORD 

Format: DB 'ABC* 

The DB (Define Byte) and DW (Define Word) instructions may be 
followed by one or more arguments. Each argument is evaluated as 
a separate byte or word. If a DB argument is a text string 
enclosed in single or double quotes, the seven bit ASCII value of 
each character in the string is returned. 

EXPRESION CODE GENERATED ♦ 

DB 100 64 

' DB , MOM l 4D 

4F 

4D 
DW 100 64 

00 
DW 1234H,4567H 34 

12 

67 

45 



Format: DBS 'AB',CR,LF 

The DBS (Define Byte Sign) and DBZ (Define Byte Zero; 
instructions are similar to the DB instruction. They differ in 
the way they treat the termination of the command line. The DBS 
instruction sets the sign bit of the last character in the line. 
The following pairs of lines generate the same code: 

DB 'ABCDE' , •P , +128 
DBS 'ABCDEF' 

DB 'Hi there' ,CR,LF+128 
DBS , 'Hi there' ,CR f LF 

The DBZ instruction appends a zero byte to the end of the line. 
The following pairs of lines generate the same code: 

DB 'ABCDEF',0 
DBZ 'ABCDEF' 

DB 'Hi there' ,CR,LF,0 
DBS 'Hi there' ,CR,LF 
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DEFINE STORAGE 
Format: DS 200 



The DS (Define Storage^ -instruction requires one argument and 
reserves the amount of space (in bytes) determined by the value 
of the argument. The instruction does not generate any code. 
The instruction is used to allocate space in memory for variables 
and tables without specifying the contents of those locations or 
generating any code in the HEX or BIN files. For example , assume 
SIZE represents the value 100. 

I DS SIZE Reserve 100 bytes of space in memory 
I DS 14 Reserve 14 more bytes. 
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CONDITIONAL 



Format : 



IF KFLAG 
CALL BL0T2 
ENDIF 



The IF instruction requires one argument. If the value of the 
argument is zero, assembly of code is suppressed until an ELSE or 
ENDIF instruction is encountered at which time it resumes. If 
the value is non-zero, assembly continues until an ELSE 
instruction is encountered. Then, assembly is suppressed until 
an ENDIF instruction is encountered. The use of the ELSE 
instruction is optional. For example, assume SWITCH is equal to 
zero . 



1 IF 


SWITCH 


1 INR 


A 


1 ELSE 




I DCR 


A 


1 ENDIF 




1 IF 


NOT SW 


1 DCR 


A 


1 ENDIF 




1 MOV 


C,A 



Argument evaluates to zero. 
Don 1 t assemble this code. 

Assemble this code instead. 



NOT SWITCH Argument evaluates to FFFF. 
Assemble this code. 



Always assemble this code.' 

IF instructions (with optional ELSEs) may be nested to 255 
levels . 
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ENTRY , EXT 

Format: ENTRY SIN, COS 

The ENTRY instruction requires one or more arguments which are 
symbol names. It marks those symbols as entry points. The 
symbols must be defined somewhere in the program (used as a 
label, for instance). Entry point symbols are passed via the 
relocatable output file (REL file) to the linker to define the 
symbols for use by other modules. This instruction may be used 
anywhere in the program. The entry instruction is not valid when 
the assembler is generating a hex or binary file. 



Format: EXT TAN, COT 



The EXT instruction requires one or more arguments which are 
symbol names'. *It tells the assembler that those symbols are not 
defined in the current program but will be defined later in other 
modules. EXT symbols are passed via the REL file to the linker 
to be defined by entry point symbols in other modules. This 
instruction may be used anywhere in the program. The EXT 
instruction is not valid when the assembler is generating a hex 
or binary file. 
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ABS r PROG, DATA, COM 



Format: ABS 



The ABS, PROG (REL may be used instead of PROG) , and DAT2 
instructions do not require an argument. They tell the assembler 
to begin or continue generating code in a particular section. If 
code had been generated in that section before, the program 
counter points to the next available byte of storage so that code 
generation continues from where it left off last time. These 
instructions are not valid when the assembler is "generating a hex 
or binary file. 



Format: COM BLOTZ 



The COM instruction may take an eight character name as ar 
argument. If no name is given it is assumed to be blank (all 
spaces). It tells the assembler to begin or continue generating 
code in that common section in exactly the same way as the ABS,. 
PROG, and DATA instructions do. There may be as many as fifteen 
different common sections. The COM instruction is not valid wher 
the assembler is generating a hex or binary file. 
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ORG r LOAD 
Format: ORG 100H 



The ORG instruction requires an argument which is evaluated as a 
16 bit address. The instruction sets the assembler- HEX, and BIN 
program counters to that address; that is, it determines the 
starting address of the next block of code generated. The type 
of the argument (section in which it was defined) determines the 
type of the new section. For example, if GRISLY was defined, in 
the data section: 

ORG GRIBLY+100 

tells the assembler to continue generating code in the data 
section . 

ORG 20 

has an absolute argument and tells the assembler to generate code 
in the absolute section. 



If the line containing the ORG instruction contains a label, the 
label is set to the new value of the program counter* 

IGUM: ORG 123 GUM- has the value 123. 

If you are generating a COM file you may not ORG below 100H + 
BOOT and you may not ORG backwards (ORG to a iocatio: 
the current program counter) . 



Format: LOAD 1000H 



The LOAD instruction is only valid when the assembler is 
generating hex code. It is not valid when the assembler is 
generating relocatable code or COM file code, It requires an 
argument which is evaluated as a IS bit address, The instruction 
forces the code generated by the assembler to be loaded into 
memory whose address is different from the address set by the ORG 
instruction. This allows you to load code into one region of 
memory and later move it to another region for execution (for 
example, programming a PROM) . The LOAD instruction requires an 
argument. It sets the BIN and HEX program counter to the value 
of the argument but does not change the assembly program 
counter. For example, if you were writing code to be loaded at 
24H but executed at 1003H you would use the instructions: 
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1 ORG 


1003H 


1 LOAD 


24H 


ILOOP: DCR 


C 


1 JNZ 


LOOP 



Set assembler program counter to 1003H. 
Set binary and hex program counter to 24H 
OD is stored at 24H. 
C2 is stored at 25H. 
03 is stored at 26H. 
10 is stored at 27H. 
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NAME 



Format: NAME TRIG 



The NAME instruction requires an eight character name as an 
argument. This name is passed via the relocatable file to the 
linker and appears in the module name listing. This instruction 
may be given more than once in a program but only the name 
specified last is put in the REL file. If this instruction is 
not used in a program the first eight characters of the REL file 
name are used as the module name. The NAME instruction is not 
valid when the assembler is generating a hex or binary file. 
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INCLUDE 



Format: INCLUDE <filename> 



INCLUDE temporarily changes the input file to the assembler. 
This allows code in another file to be inserted into a program 
during assembly. When the INCLUDED file is exhausted, the 
assembler resumes reading the source lines from the original 
source file with the line immediately after the INCLUDE 
instruction. 



Note that nested INCLUDE files are not permitted (I.E. a file 
which is an argument to the INCLUDE instruction may not contain 
any INCLUDE instruction) . 
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LIBFILE 



Format: LIBFILE ALTLIB 



The LIBFILE instruction requires an eight character name as an 
argument. This name is passed via the relocatable file to the 
linker and tells the linker to use the file given by this command 
(with an assumed extension RED as the library file. If no 
LIBFILE command is given the linker uses the default library 
file, LIB.REL. This instruction may be given more than once in a 
program but only the LIBFILE name specified last is put in the 
REL file. The LIBFILE instruction is not valid when* the 
assembler is generating a hex or binary file. 
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EQUATE, SET 

Format: CHAR EQU 'Z» 

The EQU instruction requires a label and an argument which is 
evaluated as a 16 bit number. The label is given the 15 bit 
value. A symbol (the label) may be defined only once in a 
program with the EQU instruction. 

Format: CHAR SET 'X» 

The SET instruction is similar to the EQU instruction. It 
requires a label arid an argument which is evaluated as a 15 bit 
number. The label is given the 16 bit value. The SET 
instruction may be used to change the value of a symbol (the 
label) as often as desired. 
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END 



Format: END BLOTZ 



The END instruction may be placed at the end of a program but its 
use is optional. The END statement may have one argument 
(optional) which is evaluated as a 16 bit address. The value of 
the argument is used by the operating system as the starting 
address of the program. The starting address must be in an ABS, 
PROG, or DATA section. If it is in an EXT or COM section an 
error message is printed and the starting address is ignored. If 
no starting address is given, the operating system is able to 
load the program but not start it. If a starting address is 
given with the ORG address not equal to the LOAD address, an 
error message is printed and the starting address is ignored. (A 
program cannot be executed properly unless it is loaded at its 
execution address.) 

Program has no starting address. 
Program is started at 22H. 
Program is started at GUMBAL. 



END 




END 


22H 


END 


GUMBAL 
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LIST, NLIST, MTLIST, NMTLIST 



Format: NLIST 



on. 



The NLIST and- LIST pseudo-ops turn the listing off and back 
When NLIST is encountered it suppresses the listing. When LIS' 
is encountered it reenables the listing. 



NLIST 




MOV 


A,B 


MOV 


D,E 


LIST 




POP 


H 



Assemble this code but don't list 



Resume listing. 

The NMLIST and MLIST pseudo-ops turn the listing of macro 
definitions and expansions^ off and back on. When NMLIST is 
encountered it suppresses the listing of lines containing either 
macro definitions or macro expansions. When MLIST is encountered 
it reenables the listing. 



Format: MTLIST 



The NMTLIST and MTLIST pseudo-ops turn the listing of the texz 
part of macro expansions . off and back on. When NMTLIST in 
encountered' it suppresses the listing of the text part of -macro 
expansions (the bodies of the macros) , but does not suppress the 
listing of the hex code generated by the macros. When MTLIST is 
encountered it reenables the listing. 



- 67 - 



ASMBLE/2 



ERROR MESSAGES 



Argument too big The value of the argument is greater 

than 255 or less than -255. 

The value of an argument in an RST 
instruction is greater than seven. 

Bad argument An unknown character, number, or 

symbol is used in an argument. 

IX or IY may not be used as an 
argument with this instruction. 

Bad arithmetic operator An unknown character is used as an 

arithmetic operator. 

Bad base The starting address is in a section 

other than ABS r PROG, or DATA. 

Bad instruction An entry in the instruction field is 

not recognized as an instruction or 
. macro . 

Bad label The label does not start with a $ f %, 

. , or letter. 

Bad number The radix character is unknown. 

An improper digit appears in the 
number . 

Bad symbol The symbol does not start with a $, %, 

. , or letter. 

Can't back up in COM file Attempted to ORG to a value less than 

the current value of the program 
counter or less then 100H. Code in a 
COM file can only go forward. 

Displacement too big The value of the displacement is 

greater than 127 or less than -128. 

Division by Attempted division by zero. 

Dummy redefined A dummy argument in the macro 

definition is used more than once. 
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Extra argument 

Extra ELSE 

Extra ENDMAC 

File not found 
Macro not defined 

MACRO symbol 

Missing argument 

Missing ) 

•Multiple tag 
Nested INCLUDE 

No EOU label 

No expression 

No EXT 

No MACRO label 

No relocate 



Too many arguments are given for this 
instruction . 

The ELSE instruction does not have "a 
matching IF instruction. 

The ENDMAC instruction does not have a 
matching MACRO instruction. 

The INCLUDE file cannot be found. 

A macro is called before it is 
defined. 

A macro name is used in an instruction 
argument. 

Not enough arguments are given for the 
instruction. 

The ) is missing from the name of an 
index register. 

This label has been used before. 

The INCLUDE file calls another INCLUDE 
file. 

The. EQU instruction does not have a 
label . 

An expression is not allowed with this 
instruction, only a symbol. 

An external symbol may not be usee 

with this instruction. 

The macro definition does not have a 
label . 

A relocatable symbol may not be usee 
with this instruction or arithmetic 
operation . 

If the assembler is generating an 
absolute 'binary or hex file a 
relocatable operation is not allowed. 

A relative jump instruction jumps frois 
one relocatable section to another. 
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No SET label The SET instruction does not have a 

--"..: label. 

Not allowed in COM file The LOAD instruction cannot be used 

when generating COM file. Generate a 
HEX file instead. 

Offset not zero The starting address is given with the 

LOAD address not equal to the ORG 
address . 

Out of range The destination is too far for a 

relative jump. 

Redefined The value of the label is changed. 

A macro name is used as a non-macro 
label . 

String too long The string contains more than two 

characters . 

Symbol not found An undefined symbol is used in an 

argument. 

Symbol table full There is no more room to add symbols 

to the symbol table or to define more 
macros . 

Too many arithmetic More than one arithmetic operator is 
operators used in front of a symbol or number. 

Too many commons More than 15 common sections have been 

defined . 

Too many externals More than one external symbol has been 

used in an expression. 

Too many index registers An index register is specified for 

both arguments in a MOV instruction. 

Too many macro nest levels More than 15 macro definitions or 255 

macro expansions are nested. 
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WORKED EXAMPLE 

This section contains assembler listings of three modules. The 
first module contains the main part of the program which reads a 
string of characters from the keyboard and prints them. The 
second and third modules contain subroutines which communicate 
with either the CP/M operating system (second module) or the K3 
operating system (third module) . This program may be run with 
either operating system simply by linking the main module with 
the appropriate subroutine module. 
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String Echo. 



ASMBLE v-5b Page 1 



; String Echo. 



000D 


CR 


EQU 


13 


; Carriage return. 


000A 


: LF 


EQU 


10 


; Line feed. 



0001 



PRINT: MACRO TEXT ; Print a text string. 
LXI H f TEXT. 
CALL TXTYP 
EN DM AC 



EXT 



CI , TXTYP, MONITOR 









START: 


PRINT 


TITLE 




0000+21 


0026' 






LXI 


H r TITL) 


r 


0003+CD 


oooot 






CALL 


TXTYP 




0006 f 21 


0000" 






LXI 


H, BUFFER; 


Point to the line buffer. 


0QC9'CD 


0000# 




LOOP: 


CALL 


CI 


Get a character. 


OOOC'77 








MOV 


M,A 


Store it. 


000D*23 








INX 


H 


Bump pointer. 


OOOE'FE 


OD 






CPI 


CR 


End of line? 


OOIG'20 


F7 






JRNZ 


LOOP 


Not yet. Keep going. 


0012*36 


OA 






MVI 


M f LF 


Add a line feed. 


0014'23 








INX 


H 




0015'36 


00 






MVI 

PRINT 


M,0 
CRLF 


Mark the end of the line. 


0017+21 


36' 






LXI 


H f CRLF 




C01A+CD 


0O04# 






.CALL 

FRINT 


TXTYP 
BUFFER ; 


Echo the buffer. 


001D+21 


0000" 






LXI 


H, BUFFER 


0020+CD 


001B# 






CALL 


TXTYP 




0023'C3 


0000# 






JMP 


MONITOR ; 


And return to the monitor 


C026 T 44 


65 6D 


6FTITLE: 


DBZ 


' Demo Pr og r am ' , CR , LF , ' * * 


20 


50 72 


6F 








, • 


67 


72. 61 


6D 










OD 


OA 2A 


00 










0036'OD 


OAOO 




CRLF: 


DBZ 


CR, LF 




0000" 






DATA 






0000"0080 




BUFFER 


:DS 


128 ; 


String buffer. 


0000 ' 






END 


START 
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0000 


MON EQU 





0001 


CREAD EQU 


1 


0002 


CWRITE EQU 


2 



CP/M Operating. System Subroutines. ASMBLE v-5b Page 1 

; CP/M Operating System Subroutines. 

; These subroutines talk to the CP/M operating system. 

0001 IOP: MACRO FUNCTION; Call an I/O processor function. 

MVI C, FUNCTION 
CALL 5 
ENDMAC 

Return to the monitor. 
Read a character. 
Write a character. 

ENTRY CI , TXTYP , MONITOR 

; Read a character from the keyboard with echo. 
0000 'E5 CI: PUSH H ; Save HL. 

IOP CREAD 
00O1+0E 01 MVI C, CREAD 

0003+CD 0005 CALL 5 

OOOS'El POP H 

0007'C9 RET 

; Write a text string pointed to by HL. 

; The string ends with a null. 
0008«7E TXTYP: MOV A f M ; Get a character. 

0009*23 INX H 

0A'B7 

^jOB'CS 

000C5F 

000D'E5 

OOOE-fOE 02 

0010+CD 0005 
0013'El 

0014*18 F2 

; Return to the monitor. 

MONITOR: IOP MON 
0016+OE 00 MVI C r MON 

001S+CD 0005 CALL 5 



ORA 


A ; 


Null? 


RZ 




• Yes. Quit. 


MOV 


E,A ; 


Not yet. 


PUSH 


H J 


' Save pointer. 


IOP 


CWRITE , 


? Write character. 


MVI 


C,CWR! 


CTE 


CALL 


5 




POP 


H 




JR 


TXTYP 


f Keep going. 
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DOOO 


MON 


EQU 


D037 


CREAD 


EQU 


D03D 


CWRITE 


EQU 



K3, Operating, System Subroutines. ASMBLE „v-5b Page 1 

; K3 Operating System Subroutines. . „ 

; These subroutines talk to the K3 operating system. 

0001 IOP: MACRO FUNCTION; Call an I/O processor function^ 

CALL- FUNCTION 
ENDMAC 

0D000H ? Return to the monitor. 
MON+37H ; Read a character. 
MON+3DH ; Write a character. 

ENTRY CI ,TXTYP, MONITOR 

; Read a character from the keyboard with echo. 

CI: IOP CREAD 
0000+CD D037 CALL CREAD 

0003' 4F" MOV C,A 

IOP CWRITE ; Echo. 
0004+CD D03D CALL CWRITE 

0007'79 MOV A,C" 

0008'C9 RET 

; Write a text string pointed to by HL. 

; The string ends with a null. 
0009' 7E TXTYP: MOV A f M ; Get a character. 

OOGA'23 INX H 

Null? 



Yes. Quit. 
Not yet. 
Save pointer . 
Write character. 



000B'B7 ORA A 

000CC8 RZ 

000DMF MOV C,A 

OOOE'ES PUSH H 

IOP CWRITE 
000F+CD DO 3D CALL. CWRITE 

0012'El POP H 

0013 '18 F4 JR- TXTYP ; Keep going. 

; Return to the monitor. 
MONITOR: IOP MON 
0015+CD DOOO CALL MON 

END 
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RUNNING THE ASSEMBLER UNDER CP/M 

To run the assembler type: 

ASMBL <fn> ,<opts> ,<fn> ,<opts> , < f n> .<opts> /<type> 

where 

<fn> is a text file with the extension SRC 

<opts> is an optional list of options up to three letters 
long . 



first letter: drive to get source from. 

second letter: drive to send output file to. 

third letter: drive to send listings to. If thii 

letter is omitted, no listing is 
generated. If the letter is X f the 
listing is sent to the console 
instead of the disk. 

<type> " specif ies the type of the output file. It must be 
/COM, /HEX, or /REL. If no type is specified '/COM is 
assumed . 

If more than one file is specified, the files will be assembled 
as though they were one large file. The order in which they ars 
listed in the command line is the order in which they would 
appear in this large file (note: no "large file" is actually 
created) . The name of the last input file is used as the name o. 
the output file. If an option is not specified, or if a space is 
used in place of a letter, the default drive is used. The 
exception to this is the listing file: If a space is used, a 
listing file is created on the default drive, if nothing is 
specified, no file is created. For example: 

A> ASMBL INIT,NAVAGAT/HEX 

Assemble INIT.SRC with NAVAGAT.SRC. Get both files from drive J 
and send NAVAGAT.HEX to drive A. No listing file is generated 
because no listing drive, letter was specified. 



OASMBL INIT.A,NAVAGAT. BX 

Assemble the file INIT.SRC on drive A with 
C. Send NAVAGAT.COM to drive B. Send 
console . 



NAVAGAT.SRC on drivs 
the • listing to the 
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RUNNING THE ASSEMBLER UNDER K3 

The assembler recognizes two additional instructions under the K3 
operating system. They are as follows: 

Format: JSW 1000H 

The JSW instruction only generates code when the assembler is 
producing a BIN file under the K3 operating system. It requires 
one argument which is evaluated as a 16 bit number. The value of 
the argument is used by the operating system as the job status 
word. If the 1000H bit is set, the program may be started at the 
starting address with the operating system RUN or START 
commands. If the 2000H bit is set, the program may be restarted 
at a location three less than the starting address with the 
operating . system restart command. If the JSW instruction is not 
given, the operating system assumes a default value for the job 
status word. 

! JSW 1000H Allow the program to be started 

but not restarted. 



Format: VER '1' , » 2' 



i 

r 



The VER instruction requires three arguments which are evaluated 
as three ASCII characters. These three characters are stored 
only in the K3 BIN or K3 HEX file, and are read only by the K3 
LIMITS program. It is recommended that the first two characters 
be used for a two digit version number and that the third 
character be used for a single revision letter. If your program 
has only a single digit version number, the first character 
should be a space . 

1 VER f • , , 7 , , , b» ; version 7b. 
! VER , 2 , , t 7 , , l x' ; version 27x . 
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When the ' assembler is started it asks you for a' file 
specification. The specification is in the following format: 

DEV:NAME1.BIN( ,REL, or HEX) ,DEV:NAME2. LST=DEV:NAME3. SRC/B/RE/H/L/G/RU/E 

Not everything in the specification line needs to be typed in. 
For example, the extensions (BIN, REL f HEX, LST, SRC) are always 
filled in by the assembler and should . not be typed in. This 
means that the source file must always have a SRC extension. The 
listing file always has a LST extension, etc. 

The first entry in the specification determines the device and 
file name (if necessary) to which the BIN, REL, or HEX file is 
sent. If the output device is non-file structured (paper tape 
punch, for example) , a file name is not needed. If the output is 
sent to a file structured device and the file name is not given, 
it is given the name of the last source file. 



The /B, /RE, or /H option determines which file is generated, 
BIN, REL, or HEX. If no option is specified /B is assumed. If 
no device and file name is specified but the /B, /RE, or /H 
option is given a BIN, REL, or HEX file is assumed using the last 
source file name. Here are some examples of proper file 
specifications: 

PP:=BLOTZ Output is sent to the paper tape punch. 
DK3:TRIG*=BL0TZ Output is -sent to TRIG. BIN on DK3. 
DK0:=*BLOTZ Output is sent to BLOTZ.BIN on DKO . 

If the /G (get) or /RU (run) options are specified the assembler 



automatically sets the /B option (clears 
and generates a BIN file. At the 
operating system is asked to get (/G) or 
If any errors are detected in the 
request is suppressed. 



the /RE and /H options) 
end of the assembly the 
run (/RU) the BIN file. 
assembly, the get or run 



The second 


entry 


file name 


(if n 


the output 


devic 


example) a 


file 


file structured d 


given the 


name 


given without a 1 


with the 


name 


always the 


seco 


separated 


from 


HEX file is 


desir 



in the specification determines the device and 
ecessary) to which the listing file is sent. If 
e is non-file structured (line printer, for 

name is not needed. If the output is sent to a 
evice and the file name is not given, it is 

of the last source file. If the /L option is 
isting file specification a LST file is assumed 
of the last source file. The listing entry is 
nd entry in the specification line and is 
the first entry by a comma. If no BIN, REL, or 
ed , the line must start with a comma. 
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i .R ASMBLE DK2:=TEST/RU 

This command loads and runs the assembler, assembles DKOiTEST.SRC 
into DK2rTEST.BIN, loads, and runs DK2rTEST.BIN. 

The /E option sends error messages to the line printer. This is 
useful for generating a printed record of assembly errors. 

If control C is typed while the program is running, the assembly 
stops, all files are closed, and control returns to the monitor. 

If control is typed while the program is running, the listing 
of error messages is suppressed. If any other key is typed, the 
printing resumes. 
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